﻿
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<!-- saved from url=(0014)about:internet -->
<html xmlns:msxsl="urn:schemas-microsoft-com:xslt" xmlns:mssdk="winsdk" xmlns:script="urn:script" xmlns:build="urn:build" xmlns:MSHelp="http://msdn.microsoft.com/mshelp">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
<meta name="Description" content="Setting Symbol and Executable Image Paths in KD"/>
<meta name="MSHAttr" content="PreferredSiteName:MSDN"/>
<meta name="MSHAttr" content="PreferredLib:/library/windows/hardware"/>
<title>Setting Symbol and Executable Image Paths in KD</title>



<link rel="STYLESHEET" type="text/css" HREF="../common/backsdk4.css"/>





<style>
html,div { margin: 0; padding: 0;}

body {
	padding: 0px;
	margin: 0px;
	overflow: auto;
	height: 100%;
}

#winchm_template_button{
	float: right;
	width: 93px;
	top: 7px;
	position: relative;
	text-align: right;
	right: 5px;
	height: auto;
}

#winchm_template_top{
	padding: 0px;
	margin: 0px;
	border-bottom: 1px solid #9B9B9B;
	background-color: #B1CEFE;
}

#winchm_template_navigation{
	margin: 0px;
	padding-top: 7px;
	padding-left: 7px;
	padding-bottom: 3px;
	padding-right: 0px;
	font-size: 8.5pt;
	font-family: Arial, Helvetica, sans-serif;
	font-weight: normal;
	color: #585858;
}

#winchm_template_title{
	margin: 0px;
	padding-top: 4px;
	padding-left: 7px;
	padding-bottom: 7px;
	padding-right: 0px;
	font-size: 18px; 
	font-family: Verdana, Geneva, sans-serif;
	color: #363636;
}

#winchm_template_content{
	margin-top: 20px;
	margin-left: 15px;
	margin-bottom: 20px;
	margin-right: 15px;
	width: auto  !important;
	width: 100%;
}

#winchm_template_footer{
	border-width: 1px;
	border-color: #B1CEFE;
	border-top-style: solid;
	margin-top: 15px;
	margin-left: 15px;
	margin-bottom: 20px;
	margin-right: 15px;
	padding-top: 7px;
	padding-left: 0px;
	padding-bottom: 0px;
	padding-right: 0px;
	font-family: arial, helvetica, sans-serif;
	font-size: 8.5pt;
	color: #696969;
	width: auto;
	text-align: left;
}


#winchm_template_container{
	margin: 0px;
	padding: 0px;
	position: static;
	padding-bottom: 3px;
	overflow: auto;
	background-color: #FFFFFF;
}


@media print
{
#winchm_template_container{
	position: static;	
	margin: 0px;
	padding: 5px;
	
	width: auto;
	height: auto;
	overflow: auto;
}
#winchm_template_button{
visibility:hidden;
}
}

#winchm_template_navigation A:link	{text-decoration: none; color:#004080}
#winchm_template_navigation A:visited  {text-decoration: none; color: #004080}
#winchm_template_navigation A:active {text-decoration: none; color: #004080 }
#winchm_template_navigation A:hover {text-decoration: none;color: #0080FF}

A:link	{text-decoration: underline; color:#0033CC}
A:visited  {text-decoration: underline; color: #0033CC}
A:active {text-decoration: underline; color: #0033CC }
A:hover {text-decoration: underline;color: #FF0000;}
</style>
<script type="text/javascript">
function isMobile(){
Agent = window.navigator.userAgent;
if (Agent.indexOf("iPhone")>=1 || Agent.indexOf("iPad")>=1 || Agent.indexOf("iPod")>=1 || Agent.indexOf("Android")>=1){
return true;
}else{
return false;	
}

}
function d_onresize(){
if (window.navigator.userAgent.indexOf("MSIE")>=1){
document.getElementById('winchm_template_container').style.pixelWidth = document.body.offsetWidth - 3;
document.getElementById('winchm_template_container').style.pixelHeight = document.body.offsetHeight - document.getElementById('winchm_template_top').offsetHeight - 4;
}
document.getElementById('winchm_template_container').style.top = document.getElementById('winchm_template_top').offsetHeight + 'px';
}

function d_onbeforeprint(){
document.getElementById('winchm_template_container').style.width = 'auto';
document.getElementById('winchm_template_container').style.height = 'auto';
}

function d_onafterprint(){
d_onresize();
}

if(!isMobile()){

window.onload = d_onresize;
window.onresize = d_onresize;
window.onbeforeprint = d_onbeforeprint;
window.onafterprint = d_onafterprint;

document.write("<style>\n");
document.write("body {overflow: hidden;}\n");
document.write("#winchm_template_container {position: absolute;overflow: auto;top : 0px;right: 0px;bottom: 0px;left: 0px;}\n");
document.write("</style>\n");
}

</script>
</head>
<body><script language="JavaScript" type="text/JavaScript">
function syn(){
if(parent.nav.tree){
 if(parent.nav.tree.loaded){
  parent.nav.tree.selectNode(1242);
 }else{
  setTimeout("syn()",500);
}
  }else{
  setTimeout("syn()",500);
  }}
if(parent!=self){
  setTimeout("syn()",100);
}else{
  parent.location.href = "../../index.htm?page=debugger/setting_symbol_and_source_paths_in_kd.htm";
}
originalOnload = window.onload;
if(originalOnload==null){
window.onload = function(){parent.contentLoaded = true;};
}else{
window.onload = function(){originalOnload();parent.contentLoaded = true;};
}
</script> 


<div id="winchm_template_top">
	<div id="winchm_template_button"><A href="ending_a_debugging_session_in_kd.htm" title="Previous topic"><img id="winchm_template_prev" alt="Previous topic" src="../template2/btn_prev_n.gif" border="0"></a><A href="setting_breakpoints_in_kd.htm" title="Next topic"><img id="winchm_template_next" alt="Next topic" src="../template2/btn_next_n.gif" border="0"></a></div>
	<div id="winchm_template_navigation">Help &gt; 
<A href="introduction6.htm">Debugging Tools for Windows (WinDbg, KD, CDB, NTSD)</A> &gt; <A href="debugger_operation_win8.htm">Debugger Operation</A> &gt; <A href="debugging_using_kd_and_ntkd.htm">Debugging Using KD and NTKD</A> &gt; </div>
	<div id="winchm_template_title">Setting Symbol and Executable Image Paths in KD</div>
</div>
<div id="winchm_template_container">
	<div id="winchm_template_content"><div id="mainSection"><h2><a id="ddk_symbol_path_dbg"></a><a id="DDK_SYMBOL_PATH_DBG"></a>Symbol Path</h2>
<p>The symbol path specifies the directories where the symbol files are located. For more information about symbols and symbol files, see <a href="#Bookmark1494">Symbols</a>.</p>
<div class="alert"><b>Note</b>    If you are connected to the Internet or a corporate network, the most efficient way to access symbols is to use a symbol server. You can use a symbol server by using the srv* or symsrv* string within your symbol path. For more information about symbol servers, see <a href="#Bookmark1501">Symbol Stores and Symbol Servers</a>.</div>
<div> </div>
<p>To control the symbol path in KD, do one of the following:</p>
<ul>
<li>
<p>Enter the <a href="#Bookmark2193"><b>.sympath (Set Symbol Path)</b></a> command. If you are using a symbol server, the <a href="#Bookmark2191"><b>.symfix (Set Symbol Store Path)</b></a> command is similar to <b>.sympath</b> but saves you typing.</p>
</li>
<li>
<p>When you start the debugger, use the <b>-y</b> command-line option. See <a href="#Bookmark1904"><b>KD Command-Line Options</b></a>.</p>
</li>
<li>
<p>Before you start the debugger, use the _NT_SYMBOL_PATH and _NT_ALT_SYMBOL_PATH <a href="#Bookmark1912">environment variables</a> to set the path. The symbol path is created by appending _NT_SYMBOL_PATH after _NT_ALT_SYMBOL_PATH. (Typically, the path is set through the _NT_SYMBOL_PATH. However, you might want to use _NT_ALT_SYMBOL_PATH to override these settings in special cases, such as when you have private versions of shared symbol files.)</p>
<div class="alert"><b>Note</b>  If you use the <b>-sins</b> command-line option, the debugger ignores the symbol path environment variable.</div>
<div> </div>
</li>
</ul>
<h2><a id="Executable_Image_Path"></a><a id="executable_image_path"></a><a id="EXECUTABLE_IMAGE_PATH"></a>Executable Image Path</h2>
<h3><a id="ddk_executable_image_path_dbg"></a><a id="DDK_EXECUTABLE_IMAGE_PATH_DBG"></a></h3>
<p>An executable file is a binary file that the processor can run. These files typically have the .exe, .dll, or .sys file name extension. Executable files are also known as modules, especially when executable files are described as units of a larger application. Before the Windows operating system runs an executable file, it loads it into memory. The copy of the executable file in memory is called the executable image or the image.</p>
<div class="alert"><b>Note</b>    These terms are sometimes used imprecisely. For example, some documents might use "image" for the actual file on the disk. Also, Windows-based applications refer to the executable name, which typically includes the file name extension. But these applications refer to the module name, which does not include the file name extension. <p class="note">Also, the Windows kernel and HAL have special module names. For example, the <b>nt</b> module corresponds to the Ntoskrnl.exe file.</p>
</div>
<div> </div>
<p>The executable image path specifies the directories that the binary executable files are located in.</p>
<p>In most situations, the debugger knows the location of the executable files, so you do not have to set the path for this file. </p>
<p>However, there are situations when this path is required. For example, kernel-mode <a href="#Bookmark1562">small memory dump</a> files do not contain all of the executable files that exist in memory at the time of a stop error (that is, a crash). Similarly, user-mode minidump files do not contain the application binaries. If you set the path of the executable files, the debugger can find these binary files.</p>
<p>The debugger's executable image path is a string that consists of multiple directory paths, separated by semicolons. Relative paths are supported. However, unless you always start the debugger from the same directory, you should add a drive letter or a network share before each path. Network shares are also supported.  The debugger searches the executable image path recursively. That is, the debugger searches the subdirectories of each directory that is listed in this path.</p>
<p>To control the executable image path in KD, do one of the following:</p>
<ul>
<li>
<p>Enter the <a href="#Bookmark2100"><b>.exepath (Set Executable Path)</b></a> command.</p>
</li>
<li>
<p>When you start the debugger, use the <b>-i</b> command-line option. See <a href="#Bookmark1904"><b>KD Command-Line Options</b></a>.</p>
</li>
<li>
<p>Before you start the debugger, use the _NT_EXECUTABLE_IMAGE_PATH <a href="#Bookmark1912">environment variable</a> to set the path.</p>
<div class="alert"><b>Note</b>  If you use the <b>-sins</b> command-line option, the debugger ignores the executable image path environment variable.</div>
<div> </div></li></ul></div></div>	
	<div id="winchm_template_footer">Copyright &copy; 2019. All rights 
reserved. (To change the copyright info, just edit it in template.)</div>
</div>

</body>
</html>
